home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / pc / T.ZIP / TXT2READ.COM (.txt) < prev    next >
Encoding:
Graham's TXT2COM  |  1994-11-03  |  17.8 KB  |  250 lines

  1.  
  2.         Version 1.1 - Minor bug fixes. Fixed problem with files
  3.        shorter than 1 page and repaint of pages already displayed.
  4.  
  5.             TXT2COM is a simple program which makes an ascii text file into a
  6.        full screen display. It is useful for documentation and for "README"
  7.        files which can be shown on the screen and then printed out. The COM
  8.        file created by TXT2COM is easy to use and intuitive. There is a help
  9.        line on line 25 and an optional title on line 1. The cursor controls
  10.        move around the file and the Esc key exits.
  11.  
  12.            Creating a text COM files is easy. Enter at the dos prompt:
  13.  
  14.        TXT2COM textfile comfile heading
  15.  
  16.            Textfile is the name of the ascii textfile to be converted.
  17.        Filenames can include disk and paths. Comfile is the name of the COM
  18.        file to be created. If you leave off the .COM, the program will add
  19.        one. Heading is anything you want to appear at the top line of the
  20.        display and can be any character (except dos pipe and redirect
  21.        characters) and any number of words. Headings are automatically
  22.        centered.
  23.            I created this file by entering:
  24.  
  25.             TXT2COM TXT2COM.DOC README.COM TXT2COM DOCUMENTATION
  26.  
  27.        LIMITS:
  28.  
  29.             As a practical limit, text files should be no larger
  30.        than 50k. TXT2COM will convert files up to 55K, but there
  31.        are some factors to consider. Each line in the text file
  32.        expands the COM file by 2 bytes. The maximum size of a com
  33.        file is 64K. The driver takes up 2K. 64K - 2K - 55K leaves
  34.        7K for line numbers which is 3500 lines. If the 55k
  35.        text file averages 10 bytes per line then it has 5500 lines
  36.        and will not convert. If it has 20 bytes per line then
  37.        it contains 2,750 lines and will convert. The best way to
  38.        tell is to convert the file, display it and press the End
  39.        key. If you see garbage, then the file is too big.
  40.  
  41.  
  42.                           ~40Advanced Topics:~07
  43.  
  44.             You can write out the original text file to a file or to the
  45.        printer by choosing option "T". (Just press the T key while the COM
  46.        file is displaying the file.) The program will ask for a file name.
  47.        Simply enter the name of the file at the prompt. If you want to go to
  48.        a printer enter LPT1 or LPT2 (leave off the colon at the end).
  49.             You can control screen attributes through the use of the tilde
  50.        character (~). Normally the tilde is all but ignored. Tildes will
  51.        display as tildes except when a tilde is followed by two hex digits
  52.        or another tilde. Two tildes together mean force the display of a
  53.        single tilde, no matter what follows the second tilde. When a tilde
  54.        is followed by two hex digits the decimal number is converted to an
  55.        attribute and will change the screen colors from that point on. The
  56.        default color is 07 which is white on black. The attribute digits
  57.        will change this.
  58.             If you want to start out with an attribute other than the
  59.        default 07 just make sure that the first 3 characters of the text
  60.        file are a tilde sequence.
  61.  
  62.                 These are examples of screen attributes:
  63.  
  64.         Sequence      Display          Sequence      Display
  65.  
  66.             ~~00     ~00Screen Display~07      ~~10    ~10Screen Display~07
  67.             ~~01     ~01Screen Display~07      ~~11    ~11Screen Display~07
  68.             ~~02     ~02Screen Display~07      ~~12    ~12Screen Display~07
  69.             ~~03     ~03Screen Display~07      ~~13    ~13Screen Display~07
  70.             ~~04     ~04Screen Display~07      ~~14    ~14Screen Display~07
  71.             ~~05     ~05Screen Display~07      ~~15    ~15Screen Display~07
  72.             ~~06     ~06Screen Display~07      ~~16    ~16Screen Display~07
  73.             ~~07     ~07Screen Display~07      ~~17    ~17Screen Display~07
  74.             ~~08     ~08Screen Display~07      ~~18    ~18Screen Display~07
  75.             ~~09     ~09Screen Display~07      ~~19    ~19Screen Display~07
  76.             ~~0A     ~0AScreen Display~07      ~~1A    ~1AScreen Display~07
  77.             ~~0B     ~0BScreen Display~07      ~~1B    ~1BScreen Display~07
  78.             ~~0C     ~0CScreen Display~07      ~~1C    ~1CScreen Display~07
  79.             ~~0D     ~0DScreen Display~07      ~~1D    ~1DScreen Display~07
  80.             ~~0E     ~0EScreen Display~07      ~~1E    ~1EScreen Display~07
  81.             ~~0F     ~0FScreen Display~07      ~~1F    ~1FScreen Display~07
  82.  
  83.             ~~20     ~20Screen Display~07      ~~30    ~30Screen Display~07
  84.             ~~21     ~21Screen Display~07      ~~31    ~31Screen Display~07
  85.             ~~22     ~22Screen Display~07      ~~32    ~32Screen Display~07
  86.             ~~23     ~23Screen Display~07      ~~33    ~33Screen Display~07
  87.             ~~24     ~24Screen Display~07      ~~34    ~34Screen Display~07
  88.             ~~25     ~25Screen Display~07      ~~35    ~35Screen Display~07
  89.             ~~26     ~26Screen Display~07      ~~36    ~36Screen Display~07
  90.             ~~27     ~27Screen Display~07      ~~37    ~37Screen Display~07
  91.             ~~28     ~28Screen Display~07      ~~38    ~38Screen Display~07
  92.             ~~29     ~29Screen Display~07      ~~39    ~39Screen Display~07
  93.             ~~2A     ~2AScreen Display~07      ~~3A    ~3AScreen Display~07
  94.             ~~2B     ~2BScreen Display~07      ~~3B    ~3BScreen Display~07
  95.             ~~2C     ~2CScreen Display~07      ~~3C    ~3CScreen Display~07
  96.             ~~2D     ~2DScreen Display~07      ~~3D    ~3DScreen Display~07
  97.             ~~2E     ~2EScreen Display~07      ~~3E    ~3EScreen Display~07
  98.             ~~2F     ~2FScreen Display~07      ~~3F    ~3FScreen Display~07
  99.  
  100.             ~~40     ~40Screen Display~07      ~~50    ~50Screen Display~07
  101.             ~~41     ~41Screen Display~07      ~~51    ~51Screen Display~07
  102.             ~~42     ~42Screen Display~07      ~~52    ~52Screen Display~07
  103.             ~~43     ~43Screen Display~07      ~~53    ~53Screen Display~07
  104.             ~~44     ~44Screen Display~07      ~~54    ~54Screen Display~07
  105.             ~~45     ~45Screen Display~07      ~~55    ~55Screen Display~07
  106.             ~~46     ~46Screen Display~07      ~~56    ~56Screen Display~07
  107.             ~~47     ~47Screen Display~07      ~~57    ~57Screen Display~07
  108.             ~~48     ~48Screen Display~07      ~~58    ~58Screen Display~07
  109.             ~~49     ~49Screen Display~07      ~~59    ~59Screen Display~07
  110.             ~~4A     ~4AScreen Display~07      ~~5A    ~5AScreen Display~07
  111.             ~~4B     ~4BScreen Display~07      ~~5B    ~5BScreen Display~07
  112.             ~~4C     ~4CScreen Display~07      ~~5C    ~5CScreen Display~07
  113.             ~~4D     ~4DScreen Display~07      ~~5D    ~5DScreen Display~07
  114.             ~~4E     ~4EScreen Display~07      ~~5E    ~5EScreen Display~07
  115.             ~~4F     ~4FScreen Display~07      ~~5F    ~5FScreen Display~07
  116.  
  117.             ~~60     ~60Screen Display~07      ~~70    ~70Screen Display~07
  118.             ~~61     ~61Screen Display~07      ~~71    ~71Screen Display~07
  119.             ~~62     ~62Screen Display~07      ~~72    ~72Screen Display~07
  120.             ~~63     ~63Screen Display~07      ~~73    ~73Screen Display~07
  121.             ~~64     ~64Screen Display~07      ~~74    ~74Screen Display~07
  122.             ~~65     ~65Screen Display~07      ~~75    ~75Screen Display~07
  123.             ~~66     ~66Screen Display~07      ~~76    ~76Screen Display~07
  124.             ~~67     ~67Screen Display~07      ~~77    ~77Screen Display~07
  125.             ~~68     ~68Screen Display~07      ~~78    ~78Screen Display~07
  126.             ~~69     ~69Screen Display~07      ~~79    ~79Screen Display~07
  127.             ~~6A     ~6AScreen Display~07      ~~7A    ~7AScreen Display~07
  128.             ~~6B     ~6BScreen Display~07      ~~7B    ~7BScreen Display~07
  129.             ~~6C     ~6CScreen Display~07      ~~7C    ~7CScreen Display~07
  130.             ~~6D     ~6DScreen Display~07      ~~7D    ~7DScreen Display~07
  131.             ~~6E     ~6EScreen Display~07      ~~7E    ~7EScreen Display~07
  132.             ~~6F     ~6FScreen Display~07      ~~7F    ~7FScreen Display~07
  133.  
  134.             ~~80     ~80Screen Display~07      ~~90    ~90Screen Display~07
  135.             ~~81     ~81Screen Display~07      ~~91    ~91Screen Display~07
  136.             ~~82     ~82Screen Display~07      ~~92    ~92Screen Display~07
  137.             ~~83     ~83Screen Display~07      ~~93    ~93Screen Display~07
  138.             ~~84     ~84Screen Display~07      ~~94    ~94Screen Display~07
  139.             ~~85     ~85Screen Display~07      ~~95    ~95Screen Display~07
  140.             ~~86     ~86Screen Display~07      ~~96    ~96Screen Display~07
  141.             ~~87     ~87Screen Display~07      ~~97    ~97Screen Display~07
  142.             ~~88     ~88Screen Display~07      ~~98    ~98Screen Display~07
  143.             ~~89     ~89Screen Display~07      ~~99    ~99Screen Display~07
  144.             ~~8A     ~8AScreen Display~07      ~~9A    ~9AScreen Display~07
  145.             ~~8B     ~8BScreen Display~07      ~~9B    ~9BScreen Display~07
  146.             ~~8C     ~8CScreen Display~07      ~~9C    ~9CScreen Display~07
  147.             ~~8D     ~8DScreen Display~07      ~~9D    ~9DScreen Display~07
  148.             ~~8E     ~8EScreen Display~07      ~~9E    ~9EScreen Display~07
  149.             ~~8F     ~8FScreen Display~07      ~~9F    ~9FScreen Display~07
  150.  
  151.             ~~A0     ~A0Screen Display~07      ~~B0    ~B0Screen Display~07
  152.             ~~A1     ~A1Screen Display~07      ~~B1    ~B1Screen Display~07
  153.             ~~A2     ~A2Screen Display~07      ~~B2    ~B2Screen Display~07
  154.             ~~A3     ~A3Screen Display~07      ~~B3    ~B3Screen Display~07
  155.             ~~A4     ~A4Screen Display~07      ~~B4    ~B4Screen Display~07
  156.             ~~A5     ~A5Screen Display~07      ~~B5    ~B5Screen Display~07
  157.             ~~A6     ~A6Screen Display~07      ~~B6    ~B6Screen Display~07
  158.             ~~A7     ~A7Screen Display~07      ~~B7    ~B7Screen Display~07
  159.             ~~A8     ~A8Screen Display~07      ~~B8    ~B8Screen Display~07
  160.             ~~A9     ~A9Screen Display~07      ~~B9    ~B9Screen Display~07
  161.             ~~AA     ~AAScreen Display~07      ~~BA    ~BAScreen Display~07
  162.             ~~AB     ~ABScreen Display~07      ~~BB    ~BBScreen Display~07
  163.             ~~AC     ~ACScreen Display~07      ~~BC    ~BCScreen Display~07
  164.             ~~AD     ~ADScreen Display~07      ~~BD    ~BDScreen Display~07
  165.             ~~AE     ~AEScreen Display~07      ~~BE    ~BEScreen Display~07
  166.             ~~AF     ~AFScreen Display~07      ~~BF    ~BFScreen Display~07
  167.  
  168.             ~~C0     ~C0Screen Display~07      ~~D0    ~D0Screen Display~07
  169.             ~~C1     ~C1Screen Display~07      ~~D1    ~D1Screen Display~07
  170.             ~~C2     ~C2Screen Display~07      ~~D2    ~D2Screen Display~07
  171.             ~~C3     ~C3Screen Display~07      ~~D3    ~D3Screen Display~07
  172.             ~~C4     ~C4Screen Display~07      ~~D4    ~D4Screen Display~07
  173.             ~~C5     ~C5Screen Display~07      ~~D5    ~D5Screen Display~07
  174.             ~~C6     ~C6Screen Display~07      ~~D6    ~D6Screen Display~07
  175.             ~~C7     ~C7Screen Display~07      ~~D7    ~D7Screen Display~07
  176.             ~~C8     ~C8Screen Display~07      ~~D8    ~D8Screen Display~07
  177.             ~~C9     ~C9Screen Display~07      ~~D9    ~D9Screen Display~07
  178.             ~~CA     ~CAScreen Display~07      ~~DA    ~DAScreen Display~07
  179.             ~~CB     ~CBScreen Display~07      ~~DB    ~DBScreen Display~07
  180.             ~~CC     ~CCScreen Display~07      ~~DC    ~DCScreen Display~07
  181.             ~~CD     ~CDScreen Display~07      ~~DD    ~DDScreen Display~07
  182.             ~~CE     ~CEScreen Display~07      ~~DE    ~DEScreen Display~07
  183.             ~~CF     ~CFScreen Display~07      ~~DF    ~DFScreen Display~07
  184.  
  185.             ~~E0     ~E0Screen Display~07      ~~F0    ~F0Screen Display~07
  186.             ~~E1     ~E1Screen Display~07      ~~F1    ~F1Screen Display~07
  187.             ~~E2     ~E2Screen Display~07      ~~F2    ~F2Screen Display~07
  188.             ~~E3     ~E3Screen Display~07      ~~F3    ~F3Screen Display~07
  189.             ~~E4     ~E4Screen Display~07      ~~F4    ~F4Screen Display~07
  190.             ~~E5     ~E5Screen Display~07      ~~F5    ~F5Screen Display~07
  191.             ~~E6     ~E6Screen Display~07      ~~F6    ~F6Screen Display~07
  192.             ~~E7     ~E7Screen Display~07      ~~F7    ~F7Screen Display~07
  193.             ~~E8     ~E8Screen Display~07      ~~F8    ~F8Screen Display~07
  194.             ~~E9     ~E9Screen Display~07      ~~F9    ~F9Screen Display~07
  195.             ~~EA     ~EAScreen Display~07      ~~FA    ~FAScreen Display~07
  196.             ~~EB     ~EBScreen Display~07      ~~FB    ~FBScreen Display~07
  197.             ~~EC     ~ECScreen Display~07      ~~FC    ~FCScreen Display~07
  198.             ~~ED     ~EDScreen Display~07      ~~FD    ~FDScreen Display~07
  199.             ~~EE     ~EEScreen Display~07      ~~FE    ~FEScreen Display~07
  200.             ~~EF     ~EFScreen Display~07      ~~FF    ~FFScreen Display~07
  201.  
  202.             This is a free product to all users with the exception of those
  203.        who wish to include the COM file produced with this product in a
  204.        commercial package (not freeware, shareware or user supported). When
  205.        the output of TXT2COM is included in a Commercial product I demand a
  206.        royalty based on product price and number of sales. For more
  207.        information write to: Keith P. Graham
  208.                              238 Germonds Road
  209.                              W. Nyack, NY 10994
  210.                              (914) 623-4161
  211.  
  212.             If you have any suggestions or comments you can direct them
  213.             to Keith Graham at PC-Rockland BBS (914) 353-2176.
  214.  
  215.  
  216.  
  217.  
  218.          ----------------end-of-author's-documentation---------------
  219.  
  220.                         Software Library Information:
  221.  
  222.                    This disk copy provided as a service of
  223.  
  224.                         The Public (Software) Library
  225.  
  226.          Disks in the P(s)L are updated monthly, so if you did not get
  227.          this disk  directly from the P(s)L,  you should be aware that
  228.          the files in this set may no longer be the current versions.
  229.          For a copy of the latest monthly software library newsletter
  230.          and a list of the 800+ disks in the library, call or write
  231.  
  232.                         The Public (Software) Library
  233.                               P.O.Box 35705 - F
  234.                            Houston, TX 77235-5705
  235.                       (713) 721-6104 or (713) 721-5205
  236.  
  237.          We are not the authors of this program, nor are we associated
  238.          with the author in any way other than as a distributor of the
  239.          program in accordance with the author's terms of distribution.
  240.  
  241.          Please direct shareware payments and specific questions about
  242.          this program to the author of the program, whose name appears
  243.          elsewhere in  this documentation. If you have trouble getting
  244.          in touch with the author,  we will do whatever we can to help
  245.          you with your questions. All programs have been tested and do
  246.          run.  To report problems,  please use the form that is in the
  247.          file PROBLEM.DOC on many of our disks or in other written for-
  248.          mat with screen printouts, if possible.
  249.  
  250.